home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archivers / UUCoderWindow / UUCoderWIN.doc < prev    next >
Text File  |  1996-09-26  |  6KB  |  168 lines
  1.  
  2.  
  3.                             UUCoderWin version 1.00
  4.                                31 December, 1992
  5.  
  6.                               by Nils 'Jon' Görs
  7.  
  8.  
  9.  
  10.      What are UUCoders?
  11.      ------------------
  12.  
  13.         UUCoders are used to send a binary file via uucp or other
  14.      electronic mail systems.
  15.  
  16.         There are two kind of uucoders, one to encrypt a binary file
  17.      so that the output will only contain printable characters so it
  18.      can be placed in a message area. This is called uuencoding.
  19.  
  20.         The other one decrypts an uuencode't file to it's binary
  21.      origin. This is called uudecoding.
  22.  
  23.  
  24.  
  25.      How to use UUCoderWIN
  26.      ---------------------
  27.           Below, you'll see the User-Interface for UUCoderWindow. In my opinion
  28.     it's very easy to handle. Some functions are also available with shortcuts.
  29.  
  30.  __________________________________________________________________________
  31. |·| UUCoderWin                                                         |/\|
  32. |¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯|
  33. |         <I>nfile                                      <N>ame            |
  34. |  OX|¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯|                      |¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯|   |
  35. |     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯                        ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯    |
  36. |         <O>utFile                              DestinationDirector<y>   |
  37. |  OX|¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯|                      |¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯|   |
  38. |     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯                        ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯   |
  39. |                                                                         |
  40. |                                                                         |
  41. |    NoCheck    BinAsFileName    Xadd                 <F>lags             |
  42. |     |¯¯|          |¯¯|         |¯¯|                |¯¯¯¯¯¯¯|            |
  43. |      ¯¯            ¯¯           ¯¯                  ¯¯¯¯¯¯¯             |
  44. |                                                                         |
  45. |     __________                                      __________          |
  46. |    | <E>ncode |                                    | <D>ecode |         |
  47. |     ¯¯¯¯¯¯¯¯¯¯                                      ¯¯¯¯¯¯¯¯¯¯          |
  48. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  49.   OX        = GetFile for Infile and Outfile Use.
  50.   StringGadgets    = Infile, Outfile, Name, DestinationDirectory, Flags.
  51.  
  52.   CheckBoxes    = NoCheck, BinAsFilename, Xadd.
  53.   ButtonGadgets    = Encode, Decode.
  54.  
  55.  
  56.  
  57.      UUEncodeX
  58.      =========
  59.      Options available for UUEncodeX are:
  60.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  61.      BinAsFilename    use only the basename as filename.
  62.      XAdd        adds after every encoded line an 'X'.
  63.  
  64.      <N>ame       the name you want to call the binary file after decoding
  65.                 (if not given, <infile> is used)
  66.  
  67.      <F>lags      set a protection mode (Unix style, 000 - 777)
  68.                 Default is 644
  69.  
  70.      NOCHECK    don't add a checksum after each encoded line
  71.  
  72.  
  73.      Arguments should be given:
  74.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  75.      <I>nfile   name of the binary file which must be encoded
  76.  
  77.      <O>utfile  name of the file which must contain the encoded lines
  78.                 of the binary file
  79.  
  80.  
  81.         UUEncodeX places a filesize at the end of the encoded file which
  82.      can be used by decoding as a check.
  83.  
  84.         If the output-file already exists, UUEncodeX will ask you if you
  85.      want to overwrite it (still have some problems to recognize the task).
  86.  
  87.  
  88.  
  89.      UUDecodeX
  90.      =========
  91.      Options available for UUDecodeX are:
  92.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  93.      BinAsFilename        use only the basename of the encoded file
  94.      DestinationDirector<y>    followed by a directory, write the origin file
  95.                 to the specified directory
  96.  
  97.      NOCHECK   don't check the checksums given after each line (if present)
  98.  
  99.  
  100.      Arguments should be given:
  101.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  102.      <I>nfile   the name of the encoded file which must be decoded
  103.  
  104.  
  105.         File/Devicenames with spaces, should written in "..."
  106.  
  107.         UUDecodeX can handle encoded files which have checksums, 'X'
  108.      terminated lines or not. Any combination of these two options are
  109.      handled perfectly by UUDecodeX.
  110.  
  111.         If a size is given at the end of the encoded file UUDecodeX
  112.      will check if this matches with the size of the binary file it
  113.      decoded.
  114.  
  115.  
  116.  
  117.      Why did I made this programs?
  118.      -----------------------------
  119.  
  120.             In the past, I had to encode and decode lot of programs. But the
  121.     CLI/SHELL was not the way to do it.  In this time, I decided to create a
  122.     UserInterface for the CLI/Shell commands UUEncodeX and UUDecodeX written
  123.     by Michel Bekker. Now, it's possible to handle the UUCrunchers very easy
  124.     and quickly.
  125.  
  126.  
  127.      Bugs!
  128.      -----
  129.      I decided not to patch the original UUcoded file. So If you try to decode
  130.      a file that always exists, you'll get in trouble. 
  131.                 BE CAREFUL TO DECODE ON EXISTING FILES !!
  132.     
  133.  
  134.  
  135.  
  136.      Version changes:
  137.      ----------------
  138.  
  139.      v0.50    27 December 1992
  140.  
  141.      - First version, OS\2.0 only.
  142.  
  143.      - H&F Testphase (H&F means: Holger and Frank)
  144.  
  145.  
  146.      v1.00    29 December 1992
  147.  
  148.      - First release, added GetFileGadgets
  149.  
  150.      - '.dup' suffix routine added..
  151.  
  152.      - Workbench startup included.
  153.  
  154.  
  155.  
  156.      How to contact me?
  157.      ------------------
  158.         If you have any bug-reports, suggestions, comments etc. you can
  159.      contact me on:
  160.      Email    : N.GOERS@AWORLD.ZER
  161.  
  162.      or you can write to:
  163.  
  164.      Nils Görs
  165.      Kaiserstr.97a
  166.      5600 Wuppertal 11
  167.      Germany
  168.